---
title: IPolicyHeaderAssociation
summary: API reference for IPolicyHeaderAssociation.
status: draft
owner: SAIF Doc Gen
last_reviewed: 2026-08-21
library: SAIF.Business.Policy
reference_type: package
---

# IPolicyHeaderAssociation

`IPolicyHeaderAssociation` extends `IPolicyAssociation` with the additional display fields (policy name, agent/agency identifiers, status, period dates) needed to render an associated policy in a policy header UI, without requiring the caller to separately fetch header data for each associated policy.

## Purpose
- Enrich a base `IPolicyAssociation` with the display fields a policy header needs, avoiding a second lookup per associated policy.
- Serve as the return element type for `IPolicyAssociationType.GetPolicyHeaderAssociations`.

## Context
- Namespace: `SAIF.Business.Policy`
- Assembly/package: `SAIF.Business.Policy` (`PolicyCommon`)

## Public members
| Member | Signature | Purpose |
| --- | --- | --- |
| `PolicyName` | `ReadOnly Property PolicyName As String` | Display name of the associated policy. |
| `AgentNumber` | `ReadOnly Property AgentNumber As <type>` | Agent number servicing the associated policy. |
| `AgencySeqNum` | `ReadOnly Property AgencySeqNum As <type>` | Agency sequence number for the associated policy. |
| `PolicyStatusDescription` | `ReadOnly Property PolicyStatusDescription As String` | Human-readable status of the associated policy. |
| `PeriodEffectiveDate` | `ReadOnly Property PeriodEffectiveDate As Date` | Effective date of the associated policy's current period. |
| `PeriodExpirationDate` | `ReadOnly Property PeriodExpirationDate As Date` | Expiration date of the associated policy's current period. |

## Inherited public members

Members in this section are inherited from `IPolicyAssociation`, declared in this library.

| Member | Signature | Purpose | Origin |
| --- | --- | --- | --- |
| `PolicyNumber` | `ReadOnly Property PolicyNumber As <type>` | The associated policy's number. | `SAIF.Business.Policy` — `IPolicyAssociation` |
| `IsParent` | `ReadOnly Property IsParent As Boolean` | Whether this side of the association is the parent policy. | `SAIF.Business.Policy` — `IPolicyAssociation` |
| `AssociationType` | `ReadOnly Property AssociationType As IPolicyAssociationType` | The association type this association belongs to. | `SAIF.Business.Policy` — `IPolicyAssociation` |
| `Equals` | `Function Equals(...) As Boolean` | Equality comparison for policy associations. | `SAIF.Business.Policy` — `IPolicyAssociation` |

## Behavioral notes
- No in-repo implementer of `IPolicyHeaderAssociation` specifically was found (as distinct from `IPolicyAssociation`).**

## Constraints and usage notes
- This is a declaration-only contract; behavior is supplied entirely by implementers.

> **Note:** Statements marked with ** could not be confirmed; treat as unknown until verified.

## Sources
- SAIF.Business.Policy/IPolicyHeaderDataProvider.vb